Q3HandleStorage_Get
You can use theQ3HandleStorage_Get
function to get information about a handle storage object.
TQ3Status Q3HandleStorage_Get ( TQ3StorageObject storage, Handle *handle, unsigned long *validSize);
storage
- A handle storage object.
handle
- On entry, a pointer to a handle. On exit, a pointer to a handle to the block of memory associated with the specified storage object.
validSize
- On exit, the size, in bytes, of the block of memory whose address is returned through the
buffer
parameter.DESCRIPTION
TheQ3HandleStorage_Get
function returns, in thehandle
andvalidSize
parameters, the handle and size of the block of memory currently associated with the handle storage object specified by thestorage
parameter. Note that the returned handle is a handle to the storage object's data, not of a copy of that data.ERRORS
kQ3ErrorInvalidObjectParameter
kQ3ErrorNULLParameter